acceleratedRendering

Type

property

Summary

Specifies whether to use accelerated rendering for this stack

Syntax

set the acceleratedRendering of <stack> to { true | false }

Description

Use the acceleratedRendering property to put LiveCode into accelerated rendering mode and set the compositor properties to recommended defaults.

The acceleratedRendering property has been added to help simplify the use of the accelerated rendering features. When set to true, LiveCode automatically configures the compositor properties to the best defaults for the current platform.

When acceleratedRendering is set to true, if the compositorType has not previously been set, the engine configures the compositor properties as follows:

• Mac: compositorType = CoreGraphics, compositorTileSize = 32, compositorCacheLimit = 32Mb
• Windows/Linux: compositorType = Software, compositorTileSize = 32, compositorCacheLimit = 32Mb
• iOS (non-Retina iPhone): compositorType = OpenGL, compositorTileSize = 32, compositorCacheLimit = 16Mb
• iOS (iPad / Retina iPhone): compositorType = OpenGL, compositorTileSize = 64, compositorCacheLimit = 32Mb
• iOS (iPad Retina): compositorType = OpenGL, compositorTileSize = 64, compositorCacheLimit = 64Mb
• Android (VGA screen or smaller): compositorType = OpenGL, compositorTileSize = 32, compositorCacheLimit = 16Mb
• Android (larger than VGA screen): compositorType = OpenGL, compositorTileSize = 64, compositorCacheLimit = 32Mb

If the acceleratedRendering property is set to false, then the compositorType is set to empty.

warning

Changing the compositor settings from their defaults is only recommended for advanced users.

note

Set the acceleratedRendering property in a preOpenStack or preOpenCard handler - it is not persistent (not saved into the stackfile).

Parameters

Name	Type	Description
Stack		The name or ID of the stack.

Examples

set the acceleratedRendering of this stack to true

Related

property: compositorTileSize, layerMode, compositorType, compositorCacheLimit

Compatibility and Support

Introduced

LiveCode 5.0.2

OS

mac

windows

linux

ios

android

Platforms

desktop

mobile